Skip to content

fix(bugfix-workflow): add completeness guidance to prevent incomplete fixes#51

Draft
ambient-code[bot] wants to merge 1 commit intomainfrom
bugfix-workflow/completeness-improvements
Draft

fix(bugfix-workflow): add completeness guidance to prevent incomplete fixes#51
ambient-code[bot] wants to merge 1 commit intomainfrom
bugfix-workflow/completeness-improvements

Conversation

@ambient-code
Copy link

@ambient-code ambient-code bot commented Feb 25, 2026

Summary

Adds thoroughness and completeness guidance to the bugfix workflow to prevent incomplete implementations when fixing bugs involving state-dependent logic or interacting features.

Context

Based on 3 corrections from session-1771963475 where the agent implemented React Query polling logic but:

  • Missed the 'Error' terminal session phase (only checked Stopped, Completed, Failed)
  • Didn't understand how placeholderData: keepPreviousData interacts with polling
  • Used incomplete pattern documentation without verifying against actual codebase usage

All three corrections were marked as "incomplete" - the agent missed things that should have been done.

Changes

1. Fix Skill (workflows/bugfix/.claude/skills/fix/SKILL.md)

  • Step 1: Added guidance to check for pattern documentation in target codebase and verify completeness against actual usage
  • Step 3.5 (new): Added "Verify Completeness" section with guidance on:
    • Identifying all possible states/phases/conditions (search codebase, don't assume)
    • Understanding feature interactions (e.g., polling + pagination)
    • Verifying complete enumeration in switch/case logic
    • Example: polling with terminal session phases

2. Diagnose Skill (workflows/bugfix/.claude/skills/diagnose/SKILL.md)

  • Step 6: Added guidance to enumerate complete state space during impact assessment
  • Added guidance to document feature interactions

3. Test Skill (workflows/bugfix/.claude/skills/test/SKILL.md)

  • Step 2: Added guidance to test ALL states/phases/conditions, not just common ones
  • Added guidance to test feature interactions in combination

4. Principles (workflows/bugfix/CLAUDE.md)

  • Added new principle: "Be thorough and complete" - search codebase for complete sets of values, understand feature interactions

Impact

These changes should prevent similar incomplete implementations by:

  1. Prompting agents to search for complete lists of states/phases/conditions
  2. Encouraging verification of pattern documentation against actual codebase usage
  3. Emphasizing understanding of feature interactions
  4. Making completeness a core principle of the workflow

Testing

The changes are documentation updates to workflow guidance files. No code changes to test.

Session

https://app.ambient.dev/projects/ambient-platform-and-workflow-feedback-loop-running/sessions/session-1772032273

… fixes

Addresses feedback from session-1771963475 where the agent implemented
polling logic but missed:
- Complete list of terminal session phases (Error was omitted)
- Interaction between keepPreviousData and polling
- Verification of pattern documentation completeness

Changes:
- Add "Step 3.5: Verify Completeness" to fix skill with guidance on:
  * Identifying all possible states/phases/conditions
  * Understanding feature interactions
  * Verifying complete enumeration
  * Checking pattern documentation but verifying against codebase
- Add state space enumeration to diagnose skill's impact assessment
- Add completeness principle to CLAUDE.md
- Add guidance to test all states/phases and feature interactions

These changes promote thoroughness when implementing fixes involving
state-dependent logic or interacting features.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants